Skip to content

Fix How-To guide titles in Antora - #194

Merged
vharseko merged 1 commit into
OpenIdentityPlatform:masterfrom
vharseko:fix/how-to-guide-titles
Nov 8, 2026
Merged

vharseko merged 1 commit into
OpenIdentityPlatform:masterfrom
vharseko:fix/how-to-guide-titles

Conversation

@vharseko

@vharseko vharseko commented Nov 8, 2026

Copy link
Copy Markdown
Member

The How-To index displays .adoc filenames instead of guide titles because the generated Antora pages lack document headers.

Add the attribute used by the documentation generator to promote each guide's heading for Antora while preserving its chapter level in the PDF.

Validation:

  • Build the documentation and its reactor dependencies with the man-pages profile.
  • Verify that all 13 generated Antora pages have document titles and that the PDF table of contents retains the guide headings.
  • Run the How-To link checker and its Python tests.

@vharseko
vharseko requested a review from maximthomas November 8, 2026 13:27
@vharseko vharseko added the documentation Improvements or additions to documentation label Nov 8, 2026
@vharseko
vharseko merged commit 323fd23 into OpenIdentityPlatform:master Nov 8, 2026
15 checks passed
@vharseko
vharseko deleted the fix/how-to-guide-titles branch November 8, 2026 16:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants